<!doctype html public "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Subtitle フィルタ</title>
<link rel="stylesheet" type="text/css" href="../../avisynth.css">
<link rel="stylesheet" type="text/css" href="../ja.css">
</head>
<body>
<h2>Subtitle</h2>
<p><code>Subtitle </code>(<var>clip, string text,
  int&nbsp;&quot;x&quot;,
  int&nbsp;&quot;y&quot;,
  int&nbsp;&quot;first_frame&quot;,
  int&nbsp;&quot;last_frame&quot;,
  string&nbsp;&quot;font&quot;,
  float&nbsp;&quot;size&quot;,
  int&nbsp;&quot;text_color&quot;,
  int&nbsp;&quot;halo_color&quot;,
  int&nbsp;&quot;align&quot;,
  int&nbsp;&quot;spc&quot;,
  int&nbsp;&quot;lsp&quot;,
  float&nbsp;&quot;font_width&quot;,
  float&nbsp;&quot;font_angle&quot;,
  bool&nbsp;&quot;interlaced&quot;</var>)</p>

<p><code>Subtitle </code> (<var>clip, string text</var>)</p>

<p><code>Subtitle</code> フィルタは、ある範囲のフレームにアンチエイリアス<a href="#footnote_1" class="footnote_link">*1</a>されたテキストを追加します。2 つ以上の字幕が必要なら、いくつかの <code>Subtitle</code> フィルタをつなげ合わせることによってこれを実現することも可能です。<var>text</var> 以降のパラメータはすべてオプションで、省略したり、<i>名前</i>=<i>値</i> というシンタックス<a href="#footnote_2" class="footnote_link">*2</a>を使って順番に関係なく指定することができます。</p>

<h4>パラメータ</h4>

<p><var>text</var> は、<var>first_frame</var> から <var>last_frame</var> までの範囲でクリップの上にオーバーレイされるテキストです。</p>

<p>(<var>x</var>, <var>y</var>) は、テキストの位置です。水平または垂直方向の中心座標を自動的に算出して使用するために、パラメータ <var>x</var> と <var>y</var> を -1 に設定することができます。</p>

<p><var>font</var> は、テキストのフォントです（現在のコンピュータにインストールされているすべてのフォントが利用可能です。それらのフォントは、「windows\fonts」<a href="#footnote_3" class="footnote_link">*3</a>フォルダにあります）。</p>

<p><var>size</var> は、テキストのサイズ（0.125 単位）です。</p>

<p><var>text_color</var> および <var>halo_color</var> は、16 進数値（$AARRGGBB<a href="#footnote_4" class="footnote_link">*4</a>）として指定されます。これは HTML と似ています -- # の代わりに $ から始まる<a href="#footnote_5" class="footnote_link">*5</a>ことと、4 番目のオクテット<a href="#footnote_6" class="footnote_link">*6</a>がアルファ透明度を指定することを除けば。$00RRGGBB は完全に不透明、$FF000000 は完全に透明です。この色を選択することによって、テキストの縁の色を無効化することができます。色の指定に関する詳しい情報は、<a href="../syntax_colors.htm">こちら</a>を参照してください。</p>

<p><var>align</var> パラメータは、テキストが (x,y) の位置に対して相対的にどこに配置されるのかを設定することを可能にします。次のようなテンキーに基づいています:</p>

<table border="1" width="85%">
  <tr>
    <td width="15%">&lt;左&gt; 7 &lt;上&gt;</td>
    <td width="15%">&lt;中央&gt; 8 &lt;上&gt;</td>
    <td width="15%">&lt;右&gt; 9 &lt;上&gt;</td>
    <td width="25%">align=7,8,9 はテキストの上端を y の位置に揃える</td>
  </tr>
  <tr>
    <td width="15%">&lt;左&gt; 4 &lt;ベースライン&gt;</td>
    <td width="15%">&lt;中央&gt; 5 &lt;ベースライン&gt;</td>
    <td width="15%">&lt;右&gt; 6 &lt;ベースライン&gt;</td>
    <td width="25%">align=4,5,6 はテキストのベースラインを y の位置に揃える</td>
  </tr>
  <tr>
    <td width="15%">&lt;左&gt; 1 &lt;下&gt;</td>
    <td width="15%">&lt;中央&gt; 2 &lt;下&gt;</td>
    <td width="15%">&lt;右&gt; 3 &lt;下&gt;</td>
    <td width="25%">align=1,2,3 はテキストの下端を y の位置に揃える</td>
  </tr>
  <tr>
    <td width="15%">align=1,4,7 は x から始まる</td>
    <td width="15%">align=2,5,8 は x の中央に</td>
    <td width="15%">align=3,6,9 は x で終わる</td>
    <td width="25%">&nbsp;</td>
  </tr>
</table>

<p>注: 垂直方向の中央揃えの設定はありません。</p>

<p><var>spc</var> パラメータは、文字の間隔を変更することを可能にします（0=変更なし）。テキストの間隔を広くするには正の値を、狭くするには負の値を指定することができます。このタスクを実行する SetTextCharacterExtra() 関数に関する Visual C++ のドキュメント<a href="#footnote_7" class="footnote_link">*7</a>によると、この値は論理単位<a href="#footnote_8" class="footnote_link">*8</a>であり、0.125 単位で最も近いピクセルに丸められます。これは、PC の典型的なフォントをフィルムや映画のクレジット<a href="#footnote_9" class="footnote_link">*9</a>で使用されるフォント（通常、同じ高さでも幅が広い）に調和させたり、固定した文字ごとの調整によって空白を入れたり空白を埋めたりするのに役立ちます。</p>

<p>「\n」を使った複数行の文字列が <em>v2.57</em> で追加されました。これは、<var>lsp</var> （行間）パラメータが設定された場合に使用されます。<var>lsp</var> パラメータは、0.125 ピクセル単位で 2 つの行の間に追加の行間を設定します。</p>

<p><var>font_width</var> パラメータは、CreateFont() 関数<a href="#footnote_10" class="footnote_link">*10</a>に関する Visual C++ のドキュメントによると、文字グリフのアスペクト比を 0.125 単位で変更することを可能にします。これは、GDI<a href="#footnote_11" class="footnote_link">*11</a> のデフォルトのアスペクト比と選択されたフォント本来のアスペクト比によって、<var>size</var> パラメータに関連付けられています。</p>

<p><var>font_angle</var> パラメータは、テキストのベースラインの角度を反時計回りに 0.1 度ずつ変更することを可能にします。</p>

<p><var>interlaced</var> パラメータが有効化されると、インターレースディスプレイ上の急激な垂直方向のトランジションからフリッカ<a href="#footnote_12" class="footnote_link">*12</a>を低減します。アンチエイリアスフィルタが上下のラインからピクセルの重みの 0.5 を含めるようにウィンドウを拡大することによってこれを実現し、軽い垂直方向のぼかしを効果的に適用します。</p>

<p>見られさえすれば字幕の見た目はまったく気にしないというとき（たとえば、
あるフレームのいくつかのバージョンを同時に表示するために <a href="stack.htm">StackVertical</a> やその同種のフィルタを使用していて、どれがどれか覚えておくためにラベルを付けたいとき）には、代替的な短い書式<a href="#footnote_13" class="footnote_link">*13</a>が役に立ちます。</p>

<p>このフィルタは、AviSynth の内部で <a href="version.htm">Version</a> コマンドやエラーメッセージの報告に使用されています。字幕を付ける装置は、<a href="showframes.htm">ShowFrameNumber</a> やその仲間のフィルタでも使われています。</p>

<p><b>デフォルト値</b></p>

<table border="1" width="60%">
  <tr>
    <td width="10%"><var>clip</var></td>
    <td width="50%">last<a href="#footnote_14" class="footnote_link">*14</a></td>
  </tr>
  <tr>
    <td width="10%"><var>text</var></td>
    <td width="50%">デフォルトなし。必須。</td>
  </tr>
  <tr>
    <td width="10%"><var>x</var></td>
    <td width="50%">align=1,4,7 または 指定なし: 8。align=2,5,8: -1。align=3,6,9: width<a href="#footnote_15" class="footnote_link">*15</a>-8</td>
  </tr>
  <tr>
    <td width="10%"><var>y</var></td>
    <td width="50%">align=1,2,3: height<a href="#footnote_16" class="footnote_link">*16</a>-1。align=4,5,6 または 指定なし: size。align=7,8,9: 0</td>
  </tr>
  <tr>
    <td width="10%"><var>first_frame</var></td>
    <td width="50%">0</td>
  </tr>
  <tr>
    <td width="10%"><var>last_frame</var></td>
    <td width="50%">framecount(clip)<a href="#footnote_17" class="footnote_link">*17</a>-1</td>
  </tr>
  <tr>
    <td width="10%"><var>font</var></td>
    <td width="50%">&quot;Arial&quot;</td>
  </tr>
  <tr>
    <td width="10%"><var>size</var></td>
    <td width="50%">18.0</td>
  </tr>
  <tr>
    <td width="10%"><var>text_color</var></td>
    <td width="50%">$00FFFF00 &lt;完全に不透明な黄色&gt;</td>
  </tr>
  <tr>
    <td width="10%"><var>halo_color</var></td>
    <td width="50%">0 &lt;完全に不透明な黒&gt;</td>
  </tr>
  <tr>
    <td width="10%"><var>align</var></td>
    <td width="50%">通常: 4 &lt;左＆ベースライン&gt;。x=-1: 5 &lt;水平方向の中央＆ベースライン&gt;</td>
  </tr>
  <tr>
    <td width="10%"><var>spc</var></td>
    <td width="50%">0 &lt;フォント間隔変更なし&gt;</td>
  </tr>
  <tr>
    <td width="10%"><var>lsp</var></td>
    <td width="50%">&lt;複数行無効&gt;</td>
  </tr>
  <tr>
    <td width="10%"><var>font_width</var></td>
    <td width="50%">0 &lt;システムデフォルト&gt;</td>
  </tr>
  <tr>
    <td width="10%"><var>font_angle</var></td>
    <td width="50%">0.0 度</td>
  </tr>
  <tr>
    <td width="10%"><var>interlaced</var></td>
    <td width="50%">false</td>
  </tr>
</table>

<p><b>使用例</b></p>

<pre># クリップの中央に「Hello world!」:
AviSource(&quot;D:\clip.avi&quot;)
Subtitle(&quot;Hello world!&quot;, align=5)</pre>

<pre># 指定されたフォント、大きさ、色（赤）で
# クリップの右上隅に「Hello world!」:
AviSource(&quot;D:\clip.avi&quot;)
Subtitle(&quot;Hello world!&quot;, font=&quot;georgia&quot;, size=24, \
         text_color=$ff0000, align=9)</pre>

<pre># 縁なしのテキストを複数行表示:
BlankClip()
Subtitle( \
  &quot;Some text on line 1\\nMore text on line 1\n&quot; + \
  &quot;Some text on line 2&quot;, \
         lsp=10, halo_color=$ff000000)</pre>

<p>これは、以下のようになります<a href="#footnote_18" class="footnote_link">*18</a>:</p>

<pre>1行目のテキスト\nこのテキストも1行目
2行目のテキスト</pre>

<p><b>更新履歴</b></p>

<table border="1" width="50%">
  <tr>
    <td width="10%">v2.58</td>
    <td width="50%">font_width、font_angle、interlaced の各パラメータと色のアルファブレンド<a href="#footnote_19" class="footnote_link">*19</a>を追加。</td>
  </tr>
  <tr>
    <td width="10%">v2.57</td>
    <td width="50%">複数行のテキストと行間（lsp）パラメータを追加。</td>
  </tr>
  <tr>
    <td width="10%">v2.07</td>
    <td width="50%">align パラメータと spc パラメータを追加。<br>
    y=-1 に設定すると垂直方向の中央を算出する（アラインメントに影響なし）。<br>
    x と y のデフォルト値はアラインメントに左右される（以前は x=8、y=size）</td>
  </tr>
  <tr>
    <td width="10%">v1.00</td>
    <td width="50%">x=-1 に設定すると、水平方向の中央と中央揃えを使用する（v2.07 より前はヘルプに記載されていなかった）</td>
  </tr>
</table>

<p><kbd>原文 Date: 2008/06/06 16:36:46</kbd><br>
<kbd>日本語訳 $Date: 2008/08/13 02:48:39 $</kbd></p>

<form>
<input TYPE="Button" VALUE="戻る"
onClick="history.go(-1)">
</form>

<hr>
<div id="footnote">
<ul>
  <li>訳者註:
    <ul>
      <li><a name="footnote_1" class="footnote_link">*1</a> <span class="footnote_text">参考: <a href="http://www.apec.aichi-c.ed.jp/project/joho/jissyuu/art/art.files/anti.htm">アンチエイリアス</a>、<a href="http://retouch-weblab.com/photo/anti/index.html">アンチエイリアスとは：デジカメ画像のためのphotoshop講座</a>、<a href="http://www.geocities.co.jp/Hollywood/9313/atelier/info.html">「アンチエイリアス」について</a></span></li>
      <li><a name="footnote_2" class="footnote_link">*2</a> <span class="footnote_text">この「名前=値」という形式で指定される引数は、「名前付き引数」や「キーワード引数」と呼ばれます。</span></li>
      <li><a name="footnote_3" class="footnote_link">*3</a> <span class="footnote_text">Windows2000 の場合は、「WINNT\Fonts」。</span></li>
      <li><a name="footnote_4" class="footnote_link">*4</a> <span class="footnote_text">$AARRGGBB で表される色は、それぞれ AA = 透明度、RR = 赤、GG = 緑、BB = 青に相当します。</span></li>
      <li><a name="footnote_5" class="footnote_link">*5</a> <span class="footnote_text">AviSynth では、# は すでに 1 行コメントの開始を意味する記号として使用されています。</span></li>
      <li><a name="footnote_6" class="footnote_link">*6</a> <span class="footnote_text">オクテットは情報の単位の 1 つで、1 オクテットは 8 ビットに相当します。ここでは、「4 番目のオクテット」は $AARRGGBB の AA の部分を指してます。参考: <a href="http://ja.wikipedia.org/wiki/%E3%82%AA%E3%82%AF%E3%83%86%E3%83%83%E3%83%88">オクテット - Wikipedia</a></span></li>
      <li><a name="footnote_7" class="footnote_link">*7</a> <span class="footnote_text">参考: <a href="http://msdn.microsoft.com/ja-jp/library/cc428725.aspx">SetTextCharacterExtra 関数</a></span></li>
      <li><a name="footnote_8" class="footnote_link">*8</a> <span class="footnote_text">参考: <a href="http://rararahp.cool.ne.jp/cgi-bin/lng/vc/vclng.cgi?print+200208/02080001.txt">論理単位とデバイス単位について</a></span></li>
      <li><a name="footnote_9" class="footnote_link">*9</a> <span class="footnote_text">映画やドラマの冒頭と（または）最後に流される、出演者やスタッフなどの名前の表示。謝辞。</span></li>
      <li><a name="footnote_10" class="footnote_link">*10</a> <span class="footnote_text">参考: <a href="http://msdn.microsoft.com/ja-jp/library/cc428368.aspx">CreateFont 関数</a></span></li>
      <li><a name="footnote_11" class="footnote_link">*11</a> <span class="footnote_text">参考: <a href="http://dictionary.rbbtoday.com/Details/term2470.html">GDI（ジーディーアイ。Graphics Device Interface）：RBB TODAY (ブロードバンド辞典)</a>、<a href="http://e-words.jp/w/GDI.html">GDIとは 【Graphic Device Interface】 - 意味・解説 ： IT用語辞典</a>、<a href="http://ja.wikipedia.org/wiki/Graphics_Device_Interface">Graphics Device Interface - Wikipedia</a></span></li>
      <li><a name="footnote_12" class="footnote_link">*12</a> <span class="footnote_text">一般にフリッカ（flicker）とは、画面のちらつきのことを指します。ここでは、Subtitle で追加された字幕がインターレースディスプレイでちらつくことを指していると考えられます。参考: <a href="http://ja.wikipedia.org/wiki/%E3%83%95%E3%83%AA%E3%83%83%E3%82%AB%E3%83%BC">フリッカー - Wikipedia</a></span></li>
      <li><a name="footnote_13" class="footnote_link">*13</a> <span class="footnote_text">このページの冒頭に示されているシンタックスの 2 つ目、「Subtitle (clip, string text)」を指しているものと考えられます。</span></li>
      <li><a name="footnote_14" class="footnote_link">*14</a> <span class="footnote_text">最後に処理したクリップ。</span></li>
      <li><a name="footnote_15" class="footnote_link">*15</a> <span class="footnote_text">clip の幅。</span></li>
      <li><a name="footnote_16" class="footnote_link">*16</a> <span class="footnote_text">clip の高さ。</span></li>
      <li><a name="footnote_17" class="footnote_link">*17</a> <span class="footnote_text">clip の総フレーム数。</span></li>
      <li><a name="footnote_18" class="footnote_link">*18</a> <span class="footnote_text">1 つ目の \n は、直前の \ でエスケープされているため、改行されることなく、文字そのものとして表示されます。</span></li>
      <li><a name="footnote_19" class="footnote_link">*19</a> <span class="footnote_text">ここでは、アルファ値を使って文字の色と縁の色の透明度を設定することを指しています。詳しい指定方法は、上述の text_color と halo_color の説明を参照。参考: <a href="http://e-words.jp/w/E382A2E383ABE38395E382A1E38396E383ACE383B3E38389.html">アルファブレンドとは 【alpha blend】 - 意味・解説 ： IT用語辞典</a></span></li>
    </ul>
  </li>
</ul>
</div>

</body>
</html>
